home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d19
/
qupdn4.arc
/
QUPDN4.DOC
< prev
next >
Wrap
Text File
|
1988-09-15
|
7KB
|
200 lines
QUPDN version 4.0
Released 9/10/87
for PC-Board 14.0 ONLY!
Scott M. Pazur
PO Box 582
Englishtown, NJ 07726
What is QUPDN4? Simply put, QUPDN4 reads your PC-Board user file, and
creates a report listing your top x downloaders, and/or top x uploaders.
QUPDN4 will report on actual number of transfers, and/or total bytes
transferred. The downloader report is done based on ratio, while the
upload report is based on pure numbers.
Version 4 Release Notes:
New configuration file format!
Ascii AND Ansi report capabilities
Eight possible reports can be generated
Command line DAT file specification
Up to five retries on "locked" user file
PC-Board 14.0 compatibility
Data file specifications:
Name: QUPDN.DAT
Location: Current directory or pointed to by the command line
switch /D:DatFileLoc&Name
Line 1: Path/Name of users file (a copy is made and used here)
Line 2: Number of entries to include in report (may be lower than
specified depending on security ranges - below)
Use a "0" if you want every user in range below listed.
Line 3: BBS Name
Line 4: Uploader Report specs - If you don't want the top uploaders
reported, put a "0" in column 1 of this line and go to the
next line. If you DO want the top uploaders reported, column
1 must have a "1", and column 2 must have a comma (",").
Column 3 is either "B" or "N", specifying whether to report
based on total "B"ytes transferred, or "N"umber of files.
Comma in column 4. Two more values are needed, the low and
high end of the security range to report on, separated by a
comma again. (examples below)
Line 5: Downloader Report specs - exactly the same as above.
Line 6: ASCII file report specs - if you want an ascii report - no
colors - put a "1" in column 1, comma, and report name.
If you do not want a plain ascii report, put "0" in column 1.
Line 7: ANSI file report specs - same as Line 6, but this is for the
colorized version. Yes, you can do both, but use different
file names (obviously).
DO NOT PUT ANY SPACES IN LINES 4 THRU 7!!
Examples:
======================================================================
C:\PCB\MAIN\USERS
15
The Extinct Flea Market BBS
1,B,15,75
1,N,15,99
1,C:\PCB\GEN\BLT9
1,C:\PCB\GEN\BLT9G
--> This DAT file reports both top uploaders and downloaders, uploaders
based on total BYTES uploaded, downloaders based on NUMBER of
downloads (remember - this is a ratio where uploads are strictly
numbers). The range to include in the uploader report is 15 thru
75, and for downloaders, use the range 15 thru 99 (inclusively).
Two versions of the output will be created, ascii as BLT9 and
ansi as BLT9G. A maximum of 15 entries will be reported.
=======================================================================
C:\PCB\MAIN\USERS
0
The Testing Point
0
1,B,10,20
0
1,C:\PCB\GEN\NEWSG
--> This DAT file will report only the top downloaders, using all who
fall in the security range 10 thru 20. No ASCII version of the
report is created, but an ANSI version as NEWSG will be.
In effect, there are 8 possible reports that can be generated.
- Uploaders by BYTES
- Uploaders by NUMBER
- Downloaders by BYTES
- Downloaders by NUMBER
- Uploaders by BYTES, Downloaders by BYTES
- Uploaders by BYTES, Downloaders by NUMBER
- Uploaders by NUMBER, Downloaders by BYTES
- Uploaders by NUMBER, Downloaders by NUMBER
Note: If you tell the program to list the top 15 (for example) uploaders and
downloaders, but it only finds 10 users in the range specified in
lines 4 and 5, it will adjust itself to include only 10. Also, and
read this part carefully, if you tell it to report the top 15, and
it finds only 8 in the d/l range, and 12 in the u/l range, the report
will include only the top 8 in each catagory. In other, maybe more
confusing words, the report will list the lesser of the number of
users in the two security ranges, should either of these numbers be
less than the desired number of users to report. This is just to
keep the output report somewhat uniform.
Did you get all that? The best way to find out is to make a copy of your
user file to a floppy or something (eventhough the program only reads the
file, it's better safe than sorry) and give it a shot. If you like it,
use it. If not, don't. Simple enough.
This program is free, I hope you find it useful.
If you need to contact me, since I no longer run a board of my own, the
easiest place to find me is on one of these fine PC-Board systems:
The Right Choice BBS Spring Lake Hts NJ 201-974-8317 Public Node
1200/2400
The Jersey Shore BBS Sayreville NJ 201-613-7350 9600 w/HST
Revision History:
=============================================================================
Version 4.0:
- New configuration file format!
- Ascii AND Ansi report capabilities
- Eight possible reports can be generated
- Command line DAT file specification
- Up to five retries on "locked" user file
- PC-Board 14.0 compatibility
=============================================================================
Version 3.0:
- PC-Board 12.0 compatibility! And changed the name of the mandatory
data file to QUPDN.DAT.
=============================================================================
Version 2.0:
- Mandatory data file, PCBQUPDN.DAT, which MUST be in the directory from
which you execute QUPDN2. (layout later) The use of a data file should
allow QUPDN2 to work with version 10.0 of PC-Board. It has only been
tested with version 11.7.
- Variable number of users in report, i.e. Top 3 or Top 10 or Top 100
- User defined report title (70 chars max)
- Range of security levels to include in report.
Separate range for uploader list and downloader list. For example, if
you give SYSOPs unlimited downloads, you might not want them listed
in your top downloaders list, but you might want those that upload to
be listed as one of the top uploaders. Can be done...
- User defined report filename/location. (you might want it as NEWS
or BLTx etc)
=============================================================================
Version 1.0:
- The initial release